<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=iso-8859-1">
<title>Required Software - The Java EE 5 Tutorial</title>
<meta name="robots" content="index,follow">
<meta name="robots" content="index,follow">
<meta name="date" content="2008-10-01">
<link rel="stylesheet" type="text/css" href="css/default.css">
<link rel="stylesheet" type="text/css" href="css/ipg.css">
<link rel="stylesheet" type="text/css" href="css/j5eetutorial.css">
</head>

<body>

<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
   <tr valign="top">
      <td><p class="toc level1"><a href="docinfo.html">Document Information</a></p>
<p class="toc level1 tocsp"><a href="gexaf.html">Preface</a></p>
<p class="toc level1 tocsp"><a href="gfirp.html">Part&nbsp;I&nbsp;Introduction</a></p>
<p class="toc level2"><a href="bnaaw.html">1.&nbsp;&nbsp;Overview</a></p>
<p class="toc level2"><a href="gfiud.html">2.&nbsp;&nbsp;Using the Tutorial Examples</a></p>
<div class="onpage">
<p class="toc level3"><a href="">Required Software</a></p>
<p class="toc level4"><a href="#gexba">Tutorial Bundle</a></p>
<p class="toc level4"><a href="#gexae">Java Platform, Standard Edition</a></p>
<p class="toc level4"><a href="#gexab">Sun Java System Application Server 9.1</a></p>
<p class="toc level5"><a href="#gexbc">Application Server Installation Tips</a></p>
<p class="toc level4 tocsp"><a href="#gexaz">NetBeans IDE</a></p>
<p class="toc level4"><a href="#gexaa">Apache Ant</a></p>
</div>
<p class="toc level3 tocsp"><a href="bnadi.html">Starting and Stopping the Application Server</a></p>
<p class="toc level3"><a href="bnadj.html">Starting the Admin Console</a></p>
<p class="toc level3"><a href="bnadk.html">Starting and Stopping the Java DB Database Server</a></p>
<p class="toc level3"><a href="bnaan.html">Building the Examples</a></p>
<p class="toc level4"><a href="bnaan.html#gexaq">Building the Examples Using NetBeans IDE</a></p>
<p class="toc level4"><a href="bnaan.html#gexah">Building the Examples on the Command-Line Using Ant</a></p>
<p class="toc level3 tocsp"><a href="gexap.html">Tutorial Example Directory Structure</a></p>
<p class="toc level3"><a href="bnadl.html">Debugging Java EE Applications</a></p>
<p class="toc level4"><a href="bnadl.html#bnadm">Using the Server Log</a></p>
<p class="toc level4"><a href="bnadl.html#bnadn">Using a Debugger</a></p>
<p class="toc level1 tocsp"><a href="bnadp.html">Part&nbsp;II&nbsp;The Web Tier</a></p>
<p class="toc level2"><a href="bnadr.html">3.&nbsp;&nbsp;Getting Started with Web Applications</a></p>
<p class="toc level2"><a href="bnafd.html">4.&nbsp;&nbsp;Java Servlet Technology</a></p>
<p class="toc level2"><a href="bnagx.html">5.&nbsp;&nbsp;JavaServer Pages Technology</a></p>
<p class="toc level2"><a href="bnajo.html">6.&nbsp;&nbsp;JavaServer Pages Documents</a></p>
<p class="toc level2"><a href="bnakc.html">7.&nbsp;&nbsp;JavaServer Pages Standard Tag Library</a></p>
<p class="toc level2"><a href="bnalj.html">8.&nbsp;&nbsp;Custom Tags in JSP Pages</a></p>
<p class="toc level2"><a href="bnaon.html">9.&nbsp;&nbsp;Scripting in JSP Pages</a></p>
<p class="toc level2"><a href="bnaph.html">10.&nbsp;&nbsp;JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnaqz.html">11.&nbsp;&nbsp;Using JavaServer Faces Technology in JSP Pages</a></p>
<p class="toc level2"><a href="bnatx.html">12.&nbsp;&nbsp;Developing with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnavg.html">13.&nbsp;&nbsp;Creating Custom UI Components</a></p>
<p class="toc level2"><a href="bnawo.html">14.&nbsp;&nbsp;Configuring JavaServer Faces Applications</a></p>
<p class="toc level2"><a href="bnaxu.html">15.&nbsp;&nbsp;Internationalizing and Localizing Web Applications</a></p>
<p class="toc level1 tocsp"><a href="bnayk.html">Part&nbsp;III&nbsp;Web Services</a></p>
<p class="toc level2"><a href="bnayl.html">16.&nbsp;&nbsp;Building Web Services with JAX-WS</a></p>
<p class="toc level2"><a href="bnazf.html">17.&nbsp;&nbsp;Binding between XML Schema and Java Classes</a></p>
<p class="toc level2"><a href="bnbdv.html">18.&nbsp;&nbsp;Streaming API for XML</a></p>
<p class="toc level2"><a href="bnbhf.html">19.&nbsp;&nbsp;SOAP with Attachments API for Java</a></p>
<p class="toc level1 tocsp"><a href="bnblr.html">Part&nbsp;IV&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbls.html">20.&nbsp;&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbnb.html">21.&nbsp;&nbsp;Getting Started with Enterprise Beans</a></p>
<p class="toc level2"><a href="bnboc.html">22.&nbsp;&nbsp;Session Bean Examples</a></p>
<p class="toc level2"><a href="bnbpk.html">23.&nbsp;&nbsp;A Message-Driven Bean Example</a></p>
<p class="toc level1 tocsp"><a href="bnbpy.html">Part&nbsp;V&nbsp;Persistence</a></p>
<p class="toc level2"><a href="bnbpz.html">24.&nbsp;&nbsp;Introduction to the Java Persistence API</a></p>
<p class="toc level2"><a href="bnbrl.html">25.&nbsp;&nbsp;Persistence in the Web Tier</a></p>
<p class="toc level2"><a href="bnbrs.html">26.&nbsp;&nbsp;Persistence in the EJB Tier</a></p>
<p class="toc level2"><a href="bnbtg.html">27.&nbsp;&nbsp;The Java Persistence Query Language</a></p>
<p class="toc level1 tocsp"><a href="bnbwi.html">Part&nbsp;VI&nbsp;Services</a></p>
<p class="toc level2"><a href="bnbwj.html">28.&nbsp;&nbsp;Introduction to Security in the Java EE Platform</a></p>
<p class="toc level2"><a href="bnbyk.html">29.&nbsp;&nbsp;Securing Java EE Applications</a></p>
<p class="toc level2"><a href="bncas.html">30.&nbsp;&nbsp;Securing Web Applications</a></p>
<p class="toc level2"><a href="bncdq.html">31.&nbsp;&nbsp;The Java Message Service API</a></p>
<p class="toc level2"><a href="bncgv.html">32.&nbsp;&nbsp;Java EE Examples Using the JMS API</a></p>
<p class="toc level2"><a href="bncih.html">33.&nbsp;&nbsp;Transactions</a></p>
<p class="toc level2"><a href="bncjh.html">34.&nbsp;&nbsp;Resource Connections</a></p>
<p class="toc level2"><a href="bncjx.html">35.&nbsp;&nbsp;Connector Architecture</a></p>
<p class="toc level1 tocsp"><a href="bnckn.html">Part&nbsp;VII&nbsp;Case Studies</a></p>
<p class="toc level2"><a href="bncko.html">36.&nbsp;&nbsp;The Coffee Break Application</a></p>
<p class="toc level2"><a href="bnclz.html">37.&nbsp;&nbsp;The Duke's Bank Application</a></p>
<p class="toc level1 tocsp"><a href="gexbq.html">Part&nbsp;VIII&nbsp;Appendixes</a></p>
<p class="toc level2"><a href="bncno.html">A.&nbsp;&nbsp;Java Encoding Schemes</a></p>
<p class="toc level2"><a href="bncnq.html">B.&nbsp;&nbsp;Preparation for Java EE Certification Exams</a></p>
<p class="toc level2"><a href="bncnt.html">C.&nbsp;&nbsp;About the Authors</a></p>
<p class="toc level1 tocsp"><a href="idx-1.html">Index</a></p>
</td>
      <td width="10px">&nbsp;</td>
      <td width="705px">
         <div class="header">
             <div class="header-links-top">
                 <a href="http://java.sun.com">java.sun.com</a> |
                 <a href="http://docs.sun.com/">docs.sun.com</a><br>
             </div> 
             <img src="graphics/tutorialBanner.gif" width="704" height="120" alt="The Java&trade; EE 5 Tutorial"/>
             <div class="header-links">
	         <a href="index.html">Home</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/download.html">Download</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/doc/JavaEETutorial.pdf">PDF</a> |
                 <a href="http://java.sun.com/javaee/5/docs/api/index.html">API</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/faq.html">FAQ</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/search.html">Search</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/sendusmail.html">Feedback</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/history.html">History</a>
             </div>
             <div class="navigation">
                 <a href="gfiud.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
                 <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
                 <a href="bnadi.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
             </div>
         </div>

	 <div class="maincontent">      	 
             

<a name="gexaj"></a><h3>Required Software</h3>
<a name="indexterm-134"></a><p>The following software is required to run the examples.</p>
<ul><li><p><a href="#gexba">Tutorial Bundle</a></p></li>
<li><p><a href="#gexae">Java Platform, Standard Edition</a></p></li>
<li><p><a href="#gexab">Sun Java System Application Server 9.1</a></p></li>
<li><p><a href="#gexaz">NetBeans IDE</a></p></li>
<li><p><a href="#gexaa">Apache Ant</a></p></li></ul>


<a name="gexba"></a><h4>Tutorial Bundle</h4>
<p>The tutorial example source is contained in the tutorial bundle. To obtain the
tutorial bundle, go to <a href="http://java.sun.com/javaee/5/docs/tutorial/information/download.html">http://java.sun.com/javaee/5/docs/tutorial/information/download.html</a>. The tutorial bundle is a zip file
that you can unzip in a location of your choice.</p><p><a name="indexterm-135"></a>After you have installed the tutorial bundle, the example source code is in
the <tt></tt><i>tut-install</i><tt>/javaeetutorial5/examples/</tt> directory, where <i>tut-install</i> is the directory where you installed the tutorial.
The <tt>examples</tt> directory contains subdirectories for each of the technologies discussed in the
tutorial.</p>

<a name="gexae"></a><h4>Java Platform, Standard Edition</h4>
<p>To build, deploy, and run the examples, you need a copy of
Java Platform, Standard Edition 5.0 or Java Platform, Standard Edition 6.0 (J2SE 5.0
or JDK 6). You can download the J2SE 5.0 software from <a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">http://java.sun.com/javase/downloads/index_jdk5.jsp</a>. You can
download the JDK 6 software from <a href="http://java.sun.com/javase/downloads/">http://java.sun.com/javase/downloads/</a>.</p><p>Download the current JDK update that does not include any other software (such
as NetBeans or Java EE).</p>

<a name="gexab"></a><h4>Sun Java System Application Server 9.1</h4>
<p><a name="indexterm-136"></a><a name="indexterm-137"></a><a name="indexterm-138"></a>Sun Java System Application Server 9.1 is targeted as the build and runtime
environment for the tutorial examples. To build, deploy, and run the examples, you
need a copy of the Application Server and, optionally, NetBeans IDE. You can
download the Application Server from <a href="http://java.sun.com/javaee/downloads/">http://java.sun.com/javaee/downloads/</a>.</p><p>Scroll down to the section entitled <i>Download the Components Independently</i> and click the Download link
next to <a name="indexterm-139"></a><a name="indexterm-140"></a><a name="indexterm-141"></a>Sun Java System Application Server 9.1 (based on GlassFish V2).</p>
<hr><p><b>Note - </b>You can also run the tutorial examples using Sun Java System Application
Server 9.0, or using GlassFish V2.</p>
<hr>
<p>Refer to the <a href="http://wiki.glassfish.java.net/Wiki.jsp?page=FaqJavaEETutorialCompatibility">Java EE Tutorial Compatibility</a> Wiki page for information about the versions of the
Application Server and the Sun GlassFish Enterprise Server with which the tutorial examples
have been tested.</p>

<a name="gexbc"></a><h5>Application Server Installation Tips</h5>
<p>During the installation of the Application Server:</p>
<ul><li><p>Accept the default admin user name, and specify a password. The default user name is <tt>admin</tt>. Remember the password you specify (for example, <tt>adminadmin</tt>). You will need this user name and password.</p></li>
<li><p>Select the Don't Prompt for Admin User Name and Password radio button.</p></li>
<li><p>Note the HTTP port at which the server is installed. This tutorial assumes that you are accepting the default port of 8080. If 8080 is in use during installation and the installer chooses another port or if you decide to change it yourself, you will need to update the common build properties file (described in the next section) and the configuration files for some of the tutorial examples to reflect the correct port.</p></li></ul>
<p>This tutorial refers to the directory where you install the Application Server
as <i>as-install</i>. For example, the default installation directory on Microsoft Windows is <tt>C:\Sun\AppServer</tt>,
so <i>as-install</i> is <tt>C:\Sun\AppServer</tt>.</p><p>After you install the Application Server, add the following directories to your <tt>PATH</tt>
to avoid having to specify the full path when you use commands:</p><pre><tt></tt><i>as-install</i><tt>/bin</tt>
<tt></tt><i>as-install</i><tt>/lib/ant/bin</tt></pre>

<a name="gexaz"></a><h4>NetBeans IDE</h4>
<a name="indexterm-142"></a><p>The NetBeans integrated development environment (IDE) is a free, open-source IDE for developing
Java applications, including enterprise applications. NetBeans IDE supports the Java EE 5 platform.
You can build, package, deploy, and run the tutorial examples from within NetBeans
IDE.</p><p>You can download NetBeans IDE from <a href="http://www.netbeans.org/">http://www.netbeans.org/</a>.</p><p>Refer to the <a href="http://wiki.glassfish.java.net/Wiki.jsp?page=FaqJavaEETutorialCompatibility">Java EE Tutorial Compatibility</a> Wiki page for information about the versions of NetBeans
IDE with which the tutorial examples have been tested.</p>

<a name="gexaa"></a><h4>Apache Ant</h4>
<a name="indexterm-143"></a><p>Ant is a Java technology-based build tool developed by the Apache Software Foundation
(<a href="http://ant.apache.org/">http://ant.apache.org/</a>), and is used to build, package, and deploy the tutorial examples. Ant
is included with the Application Server. To use the <tt>ant</tt> command, add <tt></tt><i>as-install</i><tt>/lib/ant/bin</tt>
to your <tt>PATH</tt> environment variable.</p>
         </div>
         <div class="navigation">
             <a href="gfiud.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
             <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
             <a href="bnadi.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
         </div>

         <div class="copyright">
      	    <p>The material in The Java&trade; EE 5 Tutorial is <a href='docinfo.html'>copyright</a>-protected and may not be published in other works without express written permission from Sun Microsystems.</p>
      	 </div>

      </td>
   </tr>
</tbody>
</table>
</body>
</html>

